package org.ehe.finance.receipt.service;

import com.baomidou.mybatisplus.extension.service.IService;
import org.ehe.common.mybatis.core.page.PageQuery;
import org.ehe.common.mybatis.core.page.TableDataInfo;
import org.ehe.finance.receipt.domain.ErpFinanceReceipt;
import org.ehe.finance.receipt.domain.bo.ReceiptBo;
import org.ehe.finance.receipt.domain.vo.ReceiptResponseVO;
import org.ehe.finance.receipt.mapper.ReceiptMapper;

import java.math.BigDecimal;
import java.util.List;

/**
 * 收款单Service接口
 * @author :zhangnn
 * @className :ReceiptService
 * @description: TODO
 * @date 2025-09-02 14:28:00
 */
public interface ReceiptService extends IService<ErpFinanceReceipt> {
    /**
     * 分页查询收款单
     * @param queryVO 查询条件
     * @param pageQuery 分页参数
     * @return 分页结果
     */
    TableDataInfo<ReceiptResponseVO> selectReceiptPage(ReceiptBo queryVO, PageQuery pageQuery);

    /**
     * 查询收款单详情
     * @param id 收款单ID
     * @return 收款单详情
     */
    ErpFinanceReceipt getReceiptDetail(Long id);

    /**
     * 创建收款单
     * @param receiptBo 收款单业务对象
     * @return 是否成功
     */
    boolean createReceipt(ReceiptBo receiptBo);

    /**
     * 更新收款单
     * @param receiptBo 收款单业务对象
     * @return 是否成功
     */
    boolean updateReceipt(ReceiptBo receiptBo);

    /**
     * 删除收款单
     * @param id 收款单ID
     * @return 是否成功
     */
    boolean deleteReceipt(Long id);

    /**
     * 批量删除收款单
     * @param idList 收款单ID列表
     * @return 是否成功
     */
    boolean batchDeleteReceipt(List<Long> idList);

    /**
     * 更新收款金额
     * @param id 收款单ID
     * @param amount 收款金额
     * @return 是否成功
     */
    boolean updateReceiptAmount(Long id, BigDecimal amount);

    /**
     * 查询即将到期收款
     * @param days 天数
     * @return 即将到期收款列表
     */
    List<ErpFinanceReceipt> getDueReceipts(int days);

    /**
     * 客户收款统计
     * @return 统计结果
     */
    List<ReceiptMapper.ReceiptStatistics> getReceiptStatisticsByCustomer();

    /**
     * 生成收款单号
     * @return 收款单号
     */
    String generateReceiptNo();

    /**
     * 审核收款单
     * @param id 收款单ID
     * @return 是否成功
     */
    boolean auditReceipt(Long id);

    /**
     * 反审核收款单
     * @param id 收款单ID
     * @return 是否成功
     */
    boolean unauditReceipt(Long id);

    /**
     * 检查收款单号是否存在
     * @param receiptNo 收款单号
     * @param id 排除的ID
     * @return 是否存在
     */
    boolean checkReceiptNoExists(String receiptNo, Long id);
}
